home *** CD-ROM | disk | FTP | other *** search
/ Teach Yourself VRML 2 in 21 Days / Teach Yourself VRML 2 in 21 Days.iso / mac / ISO9660 / 3rdparty / POLYTRAN / dos / PT_DOS.ZIP / DOC_1 / IMP_3DS.1 < prev    next >
Encoding:
Text File  |  1996-06-13  |  3.3 KB  |  88 lines
  1. .so psroff.inc        # Include the macros needed for output to Postscript
  2. .TH Import-3D-Studio 
  3. .SH NAME
  4. imp_3ds \- 3D Studio geometry import filter
  5. .SH SYNOPSIS
  6. .PP
  7. This man page describes the options specific to the 3D Studio geometry
  8. import converter.
  9. .PP
  10. .SH EXAMPLE CONVERSION SYNTAX
  11. .PP
  12. To convert a 3D Studio file to Wavefront using the default parameters listed 
  13. in the setup.ini file:
  14. .IP
  15. pt -i 3ds -o wave filename.3ds
  16. .PP
  17. To convert a 3D Studio file to VRML and override some of the default options 
  18. in setup.ini:
  19. .IP
  20. pt -i 3ds -in-3ds-debug = yes -o vrml filename.3ds
  21. .PP
  22. .SH OVERVIEW
  23. .PP
  24. The 3D Studio geometry import converter reads in all objects, materials,
  25. lights, cameras and other auxiliary data from a .3ds binary file. Versions
  26. 1 through 4 of the .3ds file format are accommodated. It can also read in
  27. data from a 3D Studio .prj (project) file and a .mli (material) file.
  28. .PP
  29. .SH COMMAND LINE OPTIONS
  30. .PP
  31. The following options are specific to this import converter:
  32. .TP
  33. -i 3ds
  34. This is the optional command line option which specifies that the input data
  35. is one of the supported 3D Studio file formats. If not specified then the 
  36. converter will try to guess the input file's format from its file extension
  37. and then from the contents of its file. Note that the valid file extensions
  38. are .3ds, .prj and .mli. The .prj files contains the same information as
  39. a .3ds file, but they also have user interface information that is only
  40. usable by 3D Studio. The .mli files contain material definitions which
  41. this converter reads and turns into internal material definitions.
  42. .TP
  43. -in-3ds-smooth = [ yes | no ]
  44. If 'yes', which is the default, then smoothed vertex normals will be
  45. computed based on the smoothing information contained within the 3D
  46. Studio file; this will make the resulting object(s) appear to be smooth.
  47. If set to 'no' then no smoothing will be performed, and hence the
  48. resulting object(s) will appear to be flat shaded since they have no
  49. vertex normals associated with them.
  50. .TP
  51. -in-3ds-print-stats = [ yes | no ]
  52. If 'yes', which is the default, then statistics will be displayed about the 
  53. parsed input file.
  54. .TP
  55. -in-3ds-print-warn = [ yes | no ]
  56. If 'yes' then any warnings output from the parser will be displayed. The
  57. default is 'no'.
  58. .TP
  59. -in-3ds-debug = [ yes | no ]
  60. If 'yes' then verbose parsing information will be output to the file ASCII
  61. 'debug3ds.txt' located within the current working directory. The default 
  62. is 'no'.
  63. .TP
  64. -in-3ds-read-cameras = [ yes | no ]
  65. .PD 0
  66. .TP
  67. -in-3ds-read-lights = [ yes | no ]
  68. .TP
  69. -in-3ds-read-objects = [ yes | no ]
  70. .TP
  71. -in-3ds-read-materials = [ yes | no ]
  72. .TP
  73. -in-3ds-read-other = [ yes | no ]
  74. .PD
  75. These switches allow specific sections of the 3D Studio file to be excluded
  76. or included in the import process. All default to 'yes' which means that
  77. all named entities will be read in. If set to 'no' then the named section(s)
  78. will not be read into memory. The '-in-3ds-read-other' switch
  79. pertains to the background, depth cuing and fog options of the 3D Studio
  80. file.
  81. .PP
  82. .SH LIMITATIONS
  83. .PP
  84. Any materials which use the 'metal' shading mode will be imported as
  85. the 'Phong' (smooth) shading mode.
  86. .PP
  87. The 'mask' capabilities of materials are not presently supported.
  88.